home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PRINTER / QP30.ARJ / QP.DOC next >
Text File  |  1992-03-14  |  25KB  |  667 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                          Q U I C K P R I N T
  16.  
  17.  
  18.                         An easy  and fun to use
  19.                         text file print utility
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                                Version 3.0
  44.                                                March 14, 1992
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                              DISCLAIMER
  61.  
  62.  
  63.          QuickPrint is provided as is, free of charge. There are no
  64.     warranties written or otherwise implied.  While no problems are
  65.     expected the author assumes no responsibilty for damage to data
  66.     or hardware that arises out of the use of this program.
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                               INTRODUCTION
  118.  
  119.           QuickPrint is a handy and easy to use ASCII text print
  120.      utility.  Some of the highlights of the program are:
  121.  
  122.           -    It is "human engineered" (ergonomically designed) to
  123.                provide  maximal visual input with a minimum of fuss
  124.                (more on this later).
  125.  
  126.           -    Very few keystrokes are needed to load, view and print a
  127.                file.
  128.  
  129.           -    It tells you how many pages will be printed before
  130.                printing starts.
  131.  
  132.           -    It has a progress bar to give you quick input on the
  133.                status of the printing.
  134.  
  135.           -    It tells you which page is currently being sent to
  136.                the printer.
  137.  
  138.           -    The number of the print page you are viewing is displayed.
  139.  
  140.           -    The picklist is large, easy to read, alphabetically
  141.                sorted, includes the most important file information and
  142.                searches for names alphabetically.
  143.  
  144.           -    Works with color and monochrome monitors.
  145.  
  146.           -    Will automatically provide pagination and footers (page
  147.                numbers) for unformatted files.  If a file is formatted
  148.                with form feeds then QuickPrint will not add formfeeds
  149.                or footers.  Footers can be toggled off.
  150.  
  151.           -    Files can be tagged for easy printing of multiple files.
  152.  
  153.           -    Can print with or without line numbers.
  154.  
  155.           -    Can change number of lines printed per page.
  156.                ( Default is 58 lines not including the footer ).
  157.  
  158.           -    Can add margins to left side of page.
  159.  
  160.           -    Can print blocks of text.
  161.  
  162.           -    Can delete and rename files.
  163.  
  164.           -    Can search for text.
  165.  
  166.           The major design philosophy behind QuickPrint's development
  167.      was that it should be a no frills, easy to use print utility that
  168.      will automatically provide pagination and page numbers.
  169.  
  170.           This makes it an excellent tool for printing Readme and
  171.      documentation files provided on disks with programs.  It is also
  172.      ideal for programmers wanting to print hardcopies of their code.
  173.  
  174.  
  175.  
  176.                         USING QUICKPRINT
  177.  
  178.      A.   THE PICKLIST
  179.  
  180.           QuickPrint has been compiled as QP.EXE.  It can be started by
  181.      typing QP alone or following it with a filename.  If no name is
  182.      provided a picklist will be displayed. Starting with version 2.60
  183.      QuickPrint now handles command line arguments with more flexibility.
  184.      Typing a directory on the command line (i.e. QP direct\sub1\sub) will
  185.      list the files in that directory. You can also follow the directory
  186.      with a filename and you will go directly into that file. Dos wildcards
  187.      are also supported ( i.e QP c:\temp\file.* ).
  188.  
  189.           The long horizontal window bar on the bottom displays identification
  190.      and the number of files in the directory. The central picklist window
  191.      displays the current directory's filenames, 21 names per display, sorted
  192.      alphabetically. The highlight bar is placed approximately in the middle
  193.      of the list to provide equal access to the filenames.
  194.  
  195.           The following keys will work to allow navigation through the
  196.      list:
  197.  
  198.           Home - This will put the highlight bar at the top on the very
  199.           first file.
  200.  
  201.           End - This puts the bar at the bottom on the very last
  202.           filename.
  203.  
  204.           PgDn - This pages down through the list displaying 21
  205.           filenames at a time.
  206.  
  207.           PgUp - Same as PgDn except pages up through the list.
  208.  
  209.           Up Arrow - Scrolls up through the list, one filename at a
  210.           time.
  211.  
  212.           Dn Arrow - Scrolls down through the list.
  213.  
  214.           Alpha Numeric - Any filename starting with a printable ASCII
  215.           character may be searched for by pressing the appropriate key.
  216.           For example, pressing the 'A' key will place the highlight bar
  217.           on the first filename starting with an A.  When possible this
  218.           name will be placed in the middle of the display.  This is not
  219.           case sensitive. Subsequent presses will scroll through the list
  220.           of files starting with that character. If possible, the
  221.           highlighted filename will remain in the middle of the list.
  222.  
  223.           Esc - Pressing the escape key terminates the program and
  224.           places you at the DOS prompt.
  225.  
  226.           Enter - Pressing the <Enter> key starts the main program and
  227.           loads the file currently highlighted. ** NOTE ** If you
  228.           tagged several files for printing, pressing <Enter> will
  229.           put you into a large window with the names of the tagged
  230.           files displayed.  The text is NOT viewed in the window
  231.           when printing multiple files like it is when only a single
  232.           ( untagged ) file is selected.  Keeping this in mind you may
  233.           want to view the files individually before tagging them.
  234.  
  235.           Space bar - The space bar will tag/untag a file for printing.
  236.           It serves as a toggle. This is used to create a list of several
  237.           files that are to be printed consecutively in the order they
  238.           are selected. When a file is tagged an asterick ( * ) will
  239.           appear next to the name.
  240.  
  241.           Alt-D  - This combination will untag all files at once.
  242.  
  243.           Alt-F2 - Deletes a file.  You will be given the ususal prompt
  244.           requiring a response before the file is deleted.
  245.  
  246.           Alt-F3 - Renames a file.  You can rename a file according to
  247.           DOS standards.  Incorrect names will result in an error.  If
  248.           you activate this feature and decide to leave the name as is,
  249.           simply leave the line blank and press enter.
  250.  
  251.  
  252.       B.  VIEWING FILES
  253.  
  254.           Quickprint is meant to print files and is relatively crude at
  255.      displaying them.  This feature is provided so you can quickly scan
  256.      the file to determine if it's worth printing.  The selected file is
  257.      loaded into available memory.  If not enough memory is available,
  258.      only that which will fit into memory will be loaded.  The rest of
  259.      the file will be truncated.   If this occurs, you will see 'TR'
  260.      displayed in the lower window bar just prior to the '<ESC>
  261.      to quit' message.  This has no affect on printing.  Despite
  262.      truncation, the ENTIRE file will be printed.  The file is printed
  263.      from the disc, not from memory.  Individual lines longer than 80
  264.      characters will be truncated to 80 characters on the display but
  265.      again, this does not affect the printed form.
  266.  
  267.           Because QuickPrint has to read the entire document one line at
  268.      a time, and formats each line for display, some longer files may
  269.      take quite a few seconds to be read, especially if on a floppy
  270.      disk.  After this is accomplished however, the file will be in
  271.      memory and no additional disk reads will be needed.
  272.  
  273.  
  274.           THE UPPER BAR WINDOW
  275.  
  276.           The left hand side of the bar displays the filename. To the
  277.      right of the filename it is indicated that F1 pulls up the
  278.      help screen. After viewing the help screen you may return to
  279.      viewing your document by pressing either the space bar, return
  280.      or escape keys.
  281.  
  282.           You will then see "Txt Width= 80".  This indicates how many
  283.      characters you will be printing per line.  This comes in handy when
  284.      printing in compressed mode for example and you desire to print more
  285.      than the standard 80 characters per line. *THIS IS NOT A RIGHT HAND
  286.      MARGIN*. This should be used only when you have configured your printer
  287.      to print other than 80 characters per line, such as compressed mode or
  288.      you are using fonts that print other than 80 characters per line. The
  289.      purpose of this to allow quickprint to properly format the text,
  290.      keep correct count of lines printed and to properly print the footer.
  291.      This can accessed by pressing the ALT-W combination. Valid values
  292.      are 5 - 250 characters.
  293.  
  294.           The keys operable while viewing a file are as follows:
  295.  
  296.                Alt-P - Pressing the Alt-P combination immediately
  297.                        starts printing.
  298.  
  299.                Alt-L - Will print with line numbers.
  300.  
  301.                Alt-M - Will set left hand margin. Valid margins
  302.                        are from 0 to 70 spaces.
  303.  
  304.                Alt-N - Sets number of lines printed per page.
  305.                        Valid numbers are 1 to 250.
  306.  
  307.                Alt-F - Send formfeed to printer
  308.  
  309.                Alt-R - Send linefeed to printer
  310.  
  311.                Alt-C - This version does not automatically count
  312.                        the number of pages to print. This allows
  313.                        for much quicker loading of the file. You
  314.                        can get a count of the pages by pressing
  315.                        the Alt-C combination. The count will be
  316.                        displayed on the bottom line and will be
  317.                        provided in any case when you start printing
  318.                        since the program needs this information to
  319.                        track the progress of the print job.
  320.  
  321.                Alt-X - This will immediately exit the program without
  322.                        returning to the file directory.
  323.  
  324.                Alt-F5 - Toggles on and off the printing of the footer
  325.                         ( filename, date, time and footer line ).
  326.  
  327.                Alt-F6 - Toggles printing of page number.
  328.  
  329.                Alt-W  - Set number of characters per printed line
  330.                         ( see above ).
  331.  
  332.      Block commands:
  333.  
  334.                F7 - Turn on the block feature.
  335.  
  336.                F8 - Locks the block.
  337.  
  338.                ALT-U - Unmarks the block of text.
  339.  
  340.      Navigational keys while viewing a file are:
  341.  
  342.              Home - This puts you at the very beginning of the file.
  343.                 Twenty three lines are displayed at a time.
  344.  
  345.              End - This puts you at the very end of the file.  If the
  346.                 file was truncated due to memory limitations, the last 23
  347.                 lines of the shortened file will be displayed.
  348.  
  349.              Up and Down Arrows - Scrolls the cursor one line at a time
  350.                 in their respective directions.
  351.  
  352.              Left and Right Arrows - puts the cursor at the top and
  353.                 bottom of the screen respectively.
  354.  
  355.              PgUp and PgDn - Move through the file one screen at
  356.                 a time, backward or forward respectively.
  357.  
  358.              F2 - Search for text. A window will pop up and ask for
  359.                 the text to be located.  Pressing Enter, Esc, or Space
  360.                 without typing anything will get rid of the window without
  361.                 conducting a search. ** Searching starts at the cursor
  362.                 and goes forward through the file. ALL occurences on
  363.                 the same line will be highlighted.
  364.  
  365.              F3 - Repeats the last search. If you had not previously
  366.                searched for any text a message will pop up asking you
  367.                to first start the search with F2.
  368.  
  369.           On the far right is the page number. This corresponds with
  370.      the printed page numbers.  NOTE: This is different than earlier
  371.      versions where this was the display screen number which did not
  372.      correspond to printed page numbers.
  373.  
  374.  
  375.  
  376.           THE LOWER BAR WINDOW
  377.  
  378.           This is a rather dynamic window.  Most messages and
  379.      pertinent information will be displayed here.  When viewing
  380.      the file the line number will be displayed on the left hand
  381.      side. Then, either TOP or END will be displayed if you are
  382.      at the very top or bottom of the file. Then you will see the
  383.      word BLOCK if you have have turned on the block function (F7).
  384.      More information on the block function follows shortly.
  385.      Next, the number of print pages is given.  This number will
  386.      appear only if you first press Alt-C to get a count of the pages,
  387.      or if you print the file then return to viewing it. This is how
  388.      many pages the printed document will be.  If the document contains
  389.      formfeeds this number gives a count of them.  Otherwise, a printed
  390.      page contains 58 lines of print, not including the margins and footer.
  391.      This provides roughly a one-half inch margin both at the top and
  392.      below the footer.
  393.  
  394.           Fifty eight lines printed per page is the default number.
  395.      This can be changed by pressing the ALT-N key combination. The
  396.      acceptable range of lines per page is 1 to 250. Fifty five (or less)
  397.      is recommended for laser printers. A larger number can cause the
  398.      footer to be pushed onto the next page.
  399.  
  400.           To the right of the page count the amount of lines printed
  401.      per page will be diplayed as "Li=58" with the 58 being replaced
  402.      by the proper number should you decide to change the number. If
  403.      you change this number the amount of pages to be printed will be
  404.      adjusted accordingly.
  405.  
  406.  
  407.           Just to the right of this number is the size of the margin.
  408.      The default is 0 ( "M=0" ). If the number is changed it will be
  409.      reflected in this display. For example, "M=5" for a margin of
  410.      5 spaces. The page count is not updated to reflect margin changes.
  411.  
  412.           If you select either Alt-M or Alt-N then decide to leave the
  413.      value as is, pressing enter without inputing any numbers will
  414.      abort the process and the values will remain unchanged.
  415.  
  416.           If the file was too big to fit in memory the letters "TR"
  417.      will appear after the margin number to indicate that the file
  418.      was (TR)uncated to fit in memory. Again, this has no effect on the
  419.      final print job.
  420.  
  421.           You will then see "FN". These two letters indicate that the
  422.      (F)ooter and page (N)umber will be printed.  You can toggle the
  423.      printing of these two components by pressing the Alt-F5 combination
  424.      for the footer and Alt-F6 for page number.  If you print with only
  425.      the page number it will be approximately centered on the bottom
  426.      of the page.  The footer (F) component contains the filename,
  427.      file date, file time and the line that runs across the page bottom.
  428.  
  429.           Finally, the last bit of information is self-explanatory.
  430.      <Esc> will always stop printing or terminate the viewing of a file.
  431.      If viewing a file it will put you back at the file directory. Pressing
  432.      the ALT-X combination will immediately exit the program and put
  433.      you back at the DOS prompt without displaying the filename list. If
  434.      you tagged files for a list <Esc> will put you back at the picklist.
  435.  
  436.  
  437.  
  438.      C.   PRINTING
  439.  
  440.           At any time you may start printing by pressing the ALT-P key
  441.      combination. Use the ALT - L combination if line numbers are
  442.      desired .   Make sure your printer is on and the paper is
  443.      properly lined up.  It's best to start printing at about one-half
  444.      inch from the top.  This gives the best appearance of vertically
  445.      centered text, including the footer.  Printing will always start
  446.      at the beginning of the file and will print the ENTIRE file, even
  447.      if it was truncated.
  448.  
  449.           While printing you will see several windows.  If you are
  450.      printing only one file ( no files were tagged ) the large central
  451.      window will display the text as it is sent to the printer (or buffer).
  452.      Below this will be displayed a horizontal progress bar that gives
  453.      you percentage of completion.  This is handy in that it allows you
  454.      to easily see the progress of the print job.
  455.  
  456.           If you tagged several files for printing, you will see the
  457.      list of files displayed in the main window rather than the text
  458.      that is printing.  You will however be advised of the status
  459.      of the print job by the progress bar.  The bar starts over for
  460.      each file.  The file that is printing is highlited in the window.
  461.      Files whose printing is complete are diplayed in reverse video.
  462.      The very bottom window will now show on the left, the number
  463.      of total print pages (in case you forgot).  In the central part,
  464.      the page being printed will be shown.  Between this and the progress
  465.      bar you'll have plenty of visual representation of the status of
  466.      your print job.
  467.  
  468.  
  469. **        You can pause printing by pressing <ESC) or the spacebar.
  470.      At this point, any key except <ESC> will resume printing.
  471.      Pressing <ESC> again will terminate the print job and put you back
  472.      in the view mode ( or the file list if files were tagged and
  473.      you are printing from a list).  Therefore, the spacebar can act
  474.      as a toggle to alternately stop and start printing.
  475.  
  476.           If the printer is not on or not online, a message will appear
  477.      to alert you of this.
  478.  
  479.           If no formfeeds are detected, QuickPrint will add them, along
  480.      with a footer that provides the name of the file and it's date and
  481.      time on the left and the page number on the right if the the footer
  482.      toggles are on.
  483.  
  484.  
  485.  
  486.           BLOCK COMMANDS
  487.  
  488.           Pressing F7 turns on the block mode and highlights the line
  489.      the cursor is on.  The beginning of the block is anchored to this line. 
  490.      You may expand the block by moving the cursor up or down but the block
  491.      will always be anchored to the initial line. If you want to change it 
  492.      you need to unmark the block with ALT-U then move the cursor to the 
  493.      new line and press F-7 again.
  494.      
  495.           While the block mode is on, the right hand side of the lower window
  496.      will indicate how many lines are blocked. This is helpful for printing
  497.      purposes. Also, to remind you that text is blocked the word block will
  498.      be displayed in the lower window with a blinking triangle. You may print
  499.      a block by pressing the Alt-P or Alt-L key combinations.  While printing,
  500.      the line number being printed is displayed on the bottom left hand side.
  501.  
  502.           You can lock the block in place by pressing F-8.  The beginning and
  503.      end of the block are locked and the cursor is now free to move around
  504.      without affecting the blocked text.  Be careful when you block text
  505.      then scroll it off the screen.  The text is still blocked and if you
  506.      activate printing the block will print even though it's not being viewed
  507.      on the current screen.  When you lock the block with F-8, the word block
  508.      in the lower bar will be surrounded with [brackets] and the little
  509.      blinking triangle will be replaced by the opening bracket.
  510.  
  511.           When you print a block the program will send footers and formfeeds
  512.      to the printer so if you blocked more than one page of text it will skip
  513.      over the perforation. However, it will not issue a formfeed at the
  514.      end of printing. This is to enable you to be able to print several
  515.      small blocks on one sheet of paper. Be careful though. If you print
  516.      several small blocks on one page the program does not know where the
  517.      perforation is so you should manually send a formfeed (ALT-F) when you
  518.      get near the bottom of the page.
  519.  
  520.           Once you have completed printing a block you can unmark it
  521.      by pressing ALT-U. Press F7 to start the block mode again.
  522.  
  523.  
  524.      D. FINAL COMMENTS
  525.  
  526.           Since reading the file is disk intensive, it would be faster
  527.      to use your hard disk if available.  This becomes especially
  528.      important for long files.
  529.  
  530.           QuickPrint stores the file in memory in slightly smaller than
  531.      65K chunks.  It would allow more of the file to fit in memory if
  532.      memory was contiguous and not "chopped up" by other programs.
  533.      Rebooting the computer will give you the largest possible
  534.      contiguous piece of memory.  Any TSR programs, RAM print buffers,
  535.      disk-caches, etc. will decrease available RAM for use by
  536.      QuickPrint.
  537.  
  538.           This program has been compressed with LZEXE91. This is an
  539.      excellent compression program that compresses executable files
  540.      and the program still remains executable - you don't have to wait
  541.      for it to decompress.  You will notice that it can be compressed
  542.      no further by using other compression utilities such as ARC or ZIP.
  543.  
  544.           In order to keep this a simple to use program it is minimally
  545.      configurable. ** The configurable settings are now automatically
  546.      saved when you exit the program **. They will be the new default values
  547.      when the program is started up again. The values are saved in a file
  548.      called QP.CFG which is created the first time the program is run and
  549.      is stored in the same directory as QP.EXE. If the program can't find
  550.      QP.CFG it will use the original default values.
  551.  
  552.           There are no command line "switches".  If you like
  553.      this program but would like some minor changes made, let me know.
  554.      I'll see what I can do to accommodate you.
  555.  
  556.           I am interested in your questions or comments.  Please feel
  557.      free to contact me at the following address or on CompuServe.  My
  558.      CompuServe ID number is 71541,743. I may also be contacted on GEnie,
  559.      where my address is J.DEROSE1.  If you like or even dislike this
  560.      program I encourage you to let me know.  Your responses are what
  561.      keeps me motivated to improve the program. All the changes in
  562.      previous versions  were the result of user's suggestions.
  563.  
  564.           Enjoy!
  565.  
  566.           Thank you.
  567.  
  568.  
  569.      Joseph L. DeRose
  570.      825 Dora Place
  571.      Bel Air, Maryland 21014
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.        APPENDIX A
  582.      Summary of key combinations and examples of the status bars.
  583.  
  584.      F1    : Help screen.
  585.      ALT-P : PRINTS the document without line numbers.
  586.      ALT-L : PRINTS the document with line numbers.
  587.      ALT-M : Adds or changes the MARGIN on the left side.
  588.      ALT-N : Changes the number of LINES PRINTED per page.
  589.      ALT-C : COUNTS the number of pages that will be printed
  590.              taking into account the number of lines printed
  591.              per page.
  592.      ALT-F : Send FORMFEED to printer.
  593.      ALT-R : Send LINEFEED to printer.
  594.      ALT-D : UNTAG all filenames.
  595.      Space Bar : TAG/UNTAG a filename.
  596.      ALT-X : EXIT program without returning to directory.
  597.      ALT-F5: Toggles printing of (F)ooter.
  598.      ALT-F6: Toggles printing of page (N)umber.
  599.      F7    : Turns on BLOCK.
  600.      F8    : Locks BLOCK.
  601.      ALT-U : UNmarks BLOCK.
  602.      ALT-W : Characters printed per line ( text width )
  603.  
  604.      ALT-F2: Delete a file.
  605.      ALT-F3: Rename a file.
  606.  
  607.                                                                           
  608.  
  609.  
  610.  
  611.  
  612.      UPPER BAR
  613.  
  614.   File: <FILENAME.EXT>       < F1 for  HELP >  Txt Width= 80  Page: ##
  615.                     ^                          ^              ^
  616.                     |                          |              |
  617.                     |      Width of printed text              |
  618.                     |      Number of Print Page You Are Viewing
  619.                     Print Document
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.      LOWER BAR
  640.  
  641.  Line: ###     TOP [BLOCK]  4 pages    Li= 58  M= 0  TR      <ESC> to Quit
  642.  ^             ^    ^       ^          ^        ^    ^                  ^
  643.  |             |    |       |          |        |    Truncation         |
  644.  |             |    |       |          |        Margin - Left Side      |
  645.  |             |    |       |          Lines Printed per Page           |
  646.  |             |    |       Num of Pages to Print                       |
  647.  Line Number   |    Displayed When in Block Mode                        |
  648.  of Text       "TOP" When at the Top of File                            |
  649.                "END" When at the End of File                            |
  650.                                                                         |
  651.                   This will be Replaced with the Number of Blocked Lines
  652.                   when the Block Function is on.
  653.  
  654.      
  655.  
  656.  
  657.  
  658.  
  659.      LOWER BAR WHEN PRINTING
  660.  
  661.  Pages: 4           Printing: 2        Li= 58  M= 0          <ESC> to Quit
  662.         ^                     ^
  663.         |                     |
  664.         |                     Page Being Printed
  665.         |
  666.         Number of Pages That Will be Printed
  667.